home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / graphics / gifutl.zip / GIFUTIL.TXT < prev   
Text File  |  1993-12-14  |  5KB  |  152 lines
  1. GIFUTIL V1.0 - by Tim Boustead.
  2.  
  3.  
  4. Intro -
  5.  
  6. Gifutil was created out of necessity. The more files I accumulated, the more
  7. difficult it became to keep track of them. This is by no means the perfect
  8. way to catalog Gif files. But if you're like me and have a directory full of
  9. files like ZUFPL9.GIF or equally similar cryptic names, I think you'll find
  10. it useful.
  11.  
  12.  
  13. What It Does -
  14.  
  15. Originally, it was only to convert GIF87a format to GIF89a format so that I
  16. could add comments to the images. ( After a month, I tend to forget what it is
  17. I'm looking at. )  After adding comments to the files, I had trouble finding
  18. which GIF had the subject I was looking for, so I added comment searching and
  19. display.  Now it will also extract comments to a text file and list file info
  20. such as type (89a or 87a), resolution, colors, interlaced or noninterlaced, 
  21. and whether it has comments.
  22.  
  23. NOTE:     Although the examples below give specific file names. Wildcards such as
  24.      *.GIF or *.* are usually allowed. A little experimentation will tell you
  25.      what's valid and what's not.
  26.  
  27.  
  28.  
  29.  
  30. Examples of How to Use - 
  31.  
  32.  
  33. To Add or Remove Comments :
  34.  
  35. Lets assume you have an 87a gif file called OLDPIC.GIF in C:\ and you want
  36. to add some comments.
  37.  
  38. 1.   Create a Comments text file using any generic ascii text editor 
  39.      you like. (The comments will be truncated if over 4000 characters.)
  40.      Call it whatever you like. In this case we'll use C:\OLDPIC.TXT
  41.      ( C:\*.TXT would also work )
  42.  
  43. 2.   Pick a new file name or directory for the 89a version of PICTURE.GIF
  44.      Do not attempt to overwrite the original, GIFUTIL won't let you.
  45.      Lets use NEWPIC.GIF for the new filename.
  46.  
  47. 3.   The command looks like this: 
  48.  
  49.           GIFUTIL C:\OLDPIC.GIF C:\NEWPIC.GIF C:\PICTURE.TXT
  50.  
  51.      The following will give the same result, extensions are added if not
  52.      given.
  53.           GIFUTIL/C C:\OLDPIC C:\NEWPIC PICTURE
  54.           GIFUTIL/C C:\OLDPIC C:\NEWPIC *
  55.  
  56. To remove any comments from a GIF file, use the same procedure as above, except
  57. supply no text file name.
  58.  
  59.           GIFUTIL C:\OLDPIC C:\NEWPIC
  60.  
  61.  
  62.  
  63. To Add New Comments or Replace Comments in an 89a GIF:
  64.  
  65.      Follow the same procedure as adding comments to an 87a file. 
  66.      Any comments that were in the original will be not appear in the new
  67.      file unless they are in the text file you are adding.
  68.  
  69.  
  70. To Extract Comments from an 89a GIF:
  71.           GIFUTIL/E C:\PICTURE.GIF to create picture.txt
  72.      or   GIFUTIL/E C:\PICTURE.GIF C:\FILE.TXT to create file.txt
  73.  
  74.  
  75. To Edit Comments in an 89a GIF:
  76.  
  77.      First you must extract the comments to a text file as above:
  78.      Assuming file name is C:\PICTURE.GIF...
  79.  
  80.           GIFUTIL/E C:\PICTURE.GIF C:\PICTURE.TXT
  81.  
  82.      If you do not include the PICTURE.TXT filename, it will create a text
  83.      file with the same name as your picture file but with a .TXT extension.
  84.      The text file will be truncate if larger than 4000 characters. 
  85.  
  86.      Edit the text file using any ascii text editor you like. Then use the
  87.      same procedure as adding comments to an 87a file.
  88.  
  89.  
  90. To Search GIFs Comments for Specific Text:
  91.  
  92.      Lets assume that somewhere, you have a GIF file of Cindy Crawford, but
  93.      you don't remember what its called.  You can search all gif file
  94.      comments for Cindy and list any files that match as follows:
  95.  
  96.      GIFUTIL/F c:\pictures\*.gif cindy
  97.  
  98.      or if you want to be more specific...
  99.  
  100.      GIFUTIL/F c:\picture\*.gif "cindy crawford"
  101.  
  102.      Remember to include the quotation marks if searching for more than 1
  103.      word. Also, the search is case insensitive so you don't need to 
  104.      capitalize names. It will also ignore carriage returns, linefeeds, or
  105.      large groups of spaces.
  106.  
  107.  
  108. To Display GIF Comments:
  109.  
  110.      Assuming you found C:\CRAWFORD.GIF, you can display any comments in the
  111.      file as follows:
  112.  
  113.      GIFUTIL/D C:\CRAWFORD.GIF
  114.  
  115.      The display will pause if the comments will scroll off the screen.
  116.      Press a key to continue viewing more text. The display will truncate
  117.      file comments over 4000 characters.
  118.  
  119.  
  120. To List Files Information:
  121.  
  122.      To display file info for all GIF files in C:\ :
  123.  
  124.      GIFUTIL/I C:\*.GIF
  125.  
  126.      To display file info for GIF files in C:\ with a resolution of
  127.      640 X 480 :
  128.  
  129.      GIFUTIL/I C:\*.GIF "640X480"
  130.  
  131.  
  132. Your Comments:
  133.  
  134.      If you have any problems or suggestions for improving this program
  135.      please let me know via either CIS mail or regular mail. Type GO DIRECTORY  
  136. to find my current email address.
  137.  
  138.  
  139. Your Money:
  140.  
  141.      If you find GIFUTIL useful, but only use it occasionally, great. Keep it
  142.      it's yours. If however, you use it often, or would like a personalized
  143.      version (your name instead of 'register me'), Please send $15 plus your
  144.      name and address to the address below. I will email you a registered
  145.      version.
  146.  
  147.                Tim Boustead
  148.                639 Hillview Rd.
  149.                Cambridge, Ont.
  150.                Canada N3H 5C3
  151.  
  152.